home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / comunic / zcomm.zip / PHOMAST.DOC < prev    next >
Text File  |  1992-09-08  |  31KB  |  785 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                      PHOMAST.DOC
  9.  
  10.                                     Michael R. Ash
  11.        CompuServe: 71350,3327 Internet: mikeash@csoftec.csf.com
  12.  
  13.  
  14.           This is the latest in a series of updates to PHOMAST.T scripts
  15.           designed to get you up and running utilizing the power of
  16.           Professional-YAM or ZCOMM.  For performance and clarity I have
  17.           moved my opening remarks and instructions about setting up this
  18.           script into this file called: -> PHOMAST.DOC <-  The PHOMAST.T
  19.           file is a pure ASCII file for View and Editing.  Items below tell
  20.           you all you need to know to get up and running *FAST*.
  21.  
  22.           New features of this update include fully automated menu
  23.           configuration, autospeed detection, and lots of slick coding
  24.           examples... When run for the first time this script will generate
  25.           a new file called 'PROFILE.DAT' containing specific configuration
  26.           information that in the past you used to have to know and write
  27.           into the script with an editor in advance before using YAM or
  28.           ZCOMM.  Now when you enter 'yam' or 'zcomm' at the DOS prompt,
  29.           the script will ask you a few questions to set up the
  30.           configuration to include COM port identification and modem
  31.           initialization, and you are ready to communicate immediately
  32.           thanks to the power of the script language built into YAM and
  33.           ZCOMM!.  
  34.  
  35.           I have included comments throughout the PHOMAST.T script to help
  36.           you understand the fascinating and comprehensive script language
  37.           included in YAM and ZCOMM.  In fact, important instructions are
  38.           covered in both the phones file as well as this document.  Any
  39.           information in the PHOMAST.T script that follows a colon (:) mark
  40.           is not read/used by YAM or ZCOMM since it is interpreted as a
  41.           comment.  When you are instructed to un-comment a line it means
  42.           to load the script into an editor and delete the colon at the
  43.           start of the line so the program can use it.
  44.               
  45.           When ZCOMM is loaded it looks in the C:\ZCOMM subdirectory by
  46.           default for a file called PHOMAST.T  -=-  When YAM is loaded it
  47.           looks in the root for a file called PHONES.T (you could rename
  48.           PHOMAST.T to PHONES.T and put it in the root but there are a
  49.           couple of better ways to handle this). The simplest and most
  50.           flexible method is to use the DOS 'set phones' command (shown
  51.           below) to tell YAM/ZCOMM where to find its phones file.  Another
  52.           method is to have PUTSNP.EXE (the serial number installing
  53.           program) change the default location of the phones files.      
  54.               
  55.                            set PHONES=c:\zcomm\phomast.t   
  56.            
  57.  
  58.  
  59.  
  60.                                                                     Page: 1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           PHOMAST.DOC                                           Michael Ash
  74.  
  75.  
  76.  
  77.           The line above can be added to your AUTOEXEC.BAT file to tell YAM
  78.           where to look for its phones file.  ZCOMM users won't need to use
  79.           this line unless they want to have PHOMAST.T in another directory
  80.           since it is already the default location for ZCOMM.  The phones
  81.           file (PHOMAST.T) gives YAM/ZCOMM directions on how you want the
  82.           package to operate.
  83.                   
  84.           For those of you that haven't heard of YAM, it's the short name
  85.           for Professional-YAM, a commercial package that includes all of
  86.           ZCOMM (its shareware subset) plus advanced capabilities for
  87.           professional telecommunications requirements.     
  88.               
  89.                 
  90.                             ------------------------------
  91.               
  92.                                   --- Background ---
  93.  
  94.           When YAM/ZCOMM is first loaded it looks for a 'phones file' and
  95.           starts reading instructions at a label called 'setup:' telling
  96.           the package exactly how to operate in your system environment. 
  97.           YAM/ZCOMM is a communication environment, a tool, that utilizes
  98.           instructions found in the phones file.  It is the phones file
  99.           (this case PHOMAST.T) that is read by YAM/ZCOMM and instructions
  100.           found there are executed very much like the line by line commands
  101.           carried out in a UNIX script or a DOS BATCH file.  Basically YAM
  102.           or ZCOMM is the airplane and your phones script is the pilot the
  103.           flies the plane.
  104.  
  105.           PHOMAST.T (this phones file) is completely modular and includes a
  106.           simple HOST mode example.  Both Professional-YAM and its
  107.           shareware subset ZCOMM offer a powerful communication
  108.           environment.  Unfortunately, as with any powerful package there
  109.           is usually a steep learning curve involved.  I have worked with
  110.           the environment and generated this starter script with full
  111.           documentation to assist users at all levels in tapping the power
  112.           of this environment.  I say communication environment, because
  113.           unlike most other packages, Chuck Forsberg provides the
  114.           programming language tools you can use to build a powerful
  115.           command driven communication package you can configure to
  116.           function the way you do business, not how someone else thinks you
  117.           ought to work.
  118.  
  119.                                 --- Configuration ---
  120.  
  121.           If you want to modify the basic script, use an ASCII editor. 
  122.  
  123.  
  124.  
  125.                                                                     Page: 2
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.           PHOMAST.DOC                                           Michael Ash
  139.  
  140.  
  141.  
  142.  
  143.           QEdit on the other hand is one of the best fully configurable
  144.           shareware editors around.  Remember if you use Word Perfect in
  145.           DOS Text mode or Word Star in non-document mode, be sure to set
  146.           the margins to support a 132 character document to avoid word
  147.           wrap of long script lines.  To save time, if changes are
  148.           required, just SEARCH for sections marked with the symbol <*>. 
  149.           These changes are optional and NOT required to run the package in
  150.           most cases.
  151.  
  152.              1.  Under COLORS, you may select the alternate screen colors. 
  153.           These will be automatically set by the menu configuration and
  154.           only need to be changed if you don't like the default colors... 
  155.           To see the possible colors and their associated code numbers,
  156.           from the command line prompt enter: 'gosub color' and hit return.
  157.  
  158.              2.  Under MODEM SETUP, if your modem doesn't respond correctly
  159.           to the defaults, just select another modem setup string.  Again a
  160.           default modem string is already configured and will work in most
  161.           cases if your modem accepts the Hayes command set.
  162.  
  163.           YAM or ZCOMM once loaded reads the script (like a BATCH file in
  164.           DOS) to determine how it is to operate in your specific
  165.           configuration.  Any changes you make to the phones script
  166.           (PHOMAST.T) will change the way the package works for you.  
  167.  
  168.           YAM or ZCOMM is a 'command-line driven' package meaning you just
  169.           give it commands and it does the work.  You don't have to go
  170.           through menus unless you want to.  At the YAM/ZCOMM prompt, many
  171.           DOS and UNIX commands work. For example 'cls' clears the screen,
  172.           'dir' gives a directory (as does 'ls'), 'cd' will change
  173.           directory, 'cdd' changes both drive and directory.  I'm sure
  174.           you'll enjoy this direct approach.  To execute a DOS command at
  175.           the prompt just precede it with a '!' (e.g. !copy fileA fileB). 
  176.           At the YAM/ZCOMM prompt you can recall past commands using the up
  177.           arrow key and edit the command line at that point since YAM/ZCOMM
  178.           keeps a history of what you have entered.  The ESC key will clear
  179.           the command at the command line.
  180.  
  181.                                --- Getting On-Line ---
  182.  
  183.           To DIAL a number just enter the phone number at the YAM prompt
  184.  
  185.  
  186.  
  187.                                                                     Page: 3
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.           PHOMAST.DOC                                           Michael Ash
  201.  
  202.  
  203.  
  204.           followed by a ';t' telling it to go into terminal mode (meaning
  205.           go into the mode to talk to the other computer).  For example: 
  206.           (F9=Menu) c:/yam-> 434-5566;t  calls the phone number and once
  207.           connected puts you on line. If you want to hang up and exit the
  208.           session at any time just hit F1 to get back to the command line
  209.           and type 'off' and hit return.  Simple!
  210.  
  211.                                 --- File Transfers ---
  212.  
  213.           Downloading files is very easy.  ZModem, Kermit, and CompuServe-B
  214.           will begin a download automatically once host starts sending the
  215.           file.  To send a file up, prepare the host to accept the file by
  216.           selecting a protocol; then hit F9 for the menu or give a command
  217.           at the command line.  For example 'sz filespec' will send a file
  218.           ZModem to a host ready to receive the transfer.  In the F9 menu
  219.           you will see shortcut keys defined (e.g. F4=ASCII Upload,
  220.           F6=ZModem Upload, F7=CRC-XModem download etc.)  ASCII upload is
  221.           convenient for uploading pre-written ASCII messages.
  222.  
  223.                            --- What do I *REALLY* need ---
  224.  
  225.           To use this environment you only need YAM.EXE or ZCOMM.EXE, the
  226.           main communication program, and a phones file (PHOMAST.T) to tell
  227.           it how to act with your equipment and tastes.  Set up a
  228.           subdirectory called 'C:\ZCOMM' (using the DOS 'MD ZCOMM'
  229.           command), then place YAM.EXE or ZCOMM.EXE with the phones file
  230.           (PHOMAST.T) and help files if you want them there.  Call the
  231.           package with the COMM.BAT file or setup your own BATCH file.  If
  232.           you are using YAM or have the PHOMAST.T file somewhere other then
  233.           in the \ZCOMM subdirectory, remember to include the DOS command:
  234.           'set phones=c:\zcomm\phomast.t' in your AUTOEXEC.BAT file.  Once
  235.           it is edited into your AUTOEXEC.BAT, activate it by typing the
  236.           command 'AUTOEXEC' at the DOS prompt.
  237.  
  238.           When you first run the program with PHOMAST.T it will ask you
  239.           whether you have a PULSE dial (the older rotary type phone or
  240.           push button phone that clicks when it dials) or a TONE dial (the
  241.           push button phones that uses tones to do all the dialing).  After
  242.           you make that choice if you have to add numbers to get an outside
  243.           line for all your calls (as with a PBX system) you can have it
  244.           put that '9' or whatever numbers in for you.  Next it will look
  245.           at your hardware and try to find what COM port you have your
  246.           modem hooked to.  Make SURE your modem is ON for this test,
  247.           otherwise you will have to tell the script what COM port is used.
  248.  
  249.                                  --- Extra Stuff ---
  250.  
  251.  
  252.  
  253.                                                                     Page: 4
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.           PHOMAST.DOC                                           Michael Ash
  267.  
  268.  
  269.  
  270.           The following may be added to your AUTOEXEC.BAT file if you want
  271.           colors in your 'flash-up' help processor to match the default
  272.           colors.
  273.  
  274.           set PHONES=c:\zcomm\phomast.t   (YAM needs this particular line)
  275.           set NORMATTR=31                 (sets normal attribute)
  276.           set REVATTR=26                  (sets reverse attribute)
  277.           set UNDLATTR=31                 (sets underline attribute)
  278.  
  279.           This example expects to find YAM.EXE or ZCOMM.EXE and PHOMAST.T
  280.           in C:\ZCOMM.  Remember a ':' before a line makes it a comment in
  281.           script file.  This will activate OR deactivate lines of code.  To
  282.           turn something OFF just put a ':' in front of the line.  Words
  283.           starting in column #1 that end with a ':' are considered to be
  284.           labels...  
  285.  
  286.           To activate menu status or make a call from DOS command line
  287.           (assuming you are using ZCOMM.EXE) enter the command:
  288.  
  289.                     zcomm gosub menu  <-- or -->  zcomm call cis 
  290.  
  291.           The example on the left will bring a menu up when ZCOMM is
  292.           loaded; and the example on the right will load ZCOMM and then
  293.           call CompuServe...  This can be either via a batch file or
  294.           directly as a DOS command.  Note you can call any label in any
  295.           script file using:
  296.  
  297.                             zcomm call label.[path][file]
  298.                             zcomm gosub label.[path][file]
  299.  
  300.           If no path or file is included, the phones file is searched for
  301.           that specific label.
  302.  
  303.           Auto-log demos are set for local San Antonio numbers...  These
  304.           numbers may differ in your area and require an area code of
  305.           (512).  BNF is an example of an auto-log to a WildCat(tm) BBS,
  306.           whereas Olde Guard is an example of an auto-log to a TComm(tm)
  307.           Bulletin Board System.  
  308.  
  309.           A word about how YAM/ZCOMM displays information on the screen
  310.           follows:  Think about YAM/ZCOMM as running on four monitors on
  311.           your desk.  If this were possible you'd see the following from
  312.           left to right on the four different screens: 
  313.  
  314.            |Full-Help|  |Command Line|   |On-Line Mode|   |Circular Buffer|
  315.                  <-- move left with F1   -=-    F2 moves you right -->
  316.  
  317.  
  318.  
  319.                                                                     Page: 5
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.           PHOMAST.DOC                                           Michael Ash
  333.  
  334.  
  335.  
  336.                                    (F9 = Mini Help)
  337.  
  338.           Now, since you only have one screen, the way you switch between
  339.           the four possible displays is by using the F1 and F2 function
  340.           keys.  Picture F1 as moving you to a screen to the left and F2
  341.           moving you to a screen to the right.  If you were On-Line,
  342.           hitting F1 once would put you into command mode.  Hit F1 again
  343.           and you are in the flash-up help processor.  If you hit F2 from
  344.           On-Line mode (called terminal mode) you move into the circular
  345.           buffer (which you can also access using the PgUp, PgDn, Home and
  346.           End as well).  Hitting F1 puts you back On-Line, and F1 again
  347.           you're back to the command line...  To tell where you are, in
  348.           Full-Help you'll see a help menu, in the command mode you will
  349.           see the command line, when on-line you will see the status line
  350.           at the bottom of the screen and in the circular buffer you will
  351.           see at the bottom of the screen a message "xx.x% Review Cmd?".
  352.  
  353.  
  354.                         --- How to use the Circular Buffer ---
  355.  
  356.           One of the most powerful features of YAM/ZCOMM is the circular
  357.           buffer.  What this does is record your on-line session.  If for
  358.           example something scrolls off the screen (a listing of files
  359.           perhaps) you can pop-up and review it by hitting the PgUp/PgDn,
  360.           Home, End keys, or F2 key if you're on-line.  This takes you into
  361.           a review function where you see a history of what was on the
  362.           screen earlier.  The Home key takes you to the start or top of
  363.           the buffer, the End key takes you to the bottom.  You can tell
  364.           you are in the circular buffer since the bottom line will say
  365.           "x.xx% Review cmd?" showing you where you are in the buffer. 
  366.           Hitting the PgUp/PgDn, Home, End, and arrow keys will move you
  367.           around.  To get back on-line just hit F1 or the Return key.  
  368.  
  369.           You can search and cut info out of the circular buffer.  Say
  370.           there is a message you want to save that's scrolled off the
  371.           screen that talks about 'modems'.  Just hit the Home key to go to
  372.           the top of the buffer, enter the command 's' or '?' to search
  373.           then enter the word 'modems' and hit return.  The line with that
  374.           word will move to the top of the screen.  To cut this info, hit
  375.           't' to mark the Top, then move the messages using cursor keys
  376.           until the bottom of what you want to capture is on the top line
  377.           and hit 'b' for Bottom.  This marks the text.  Now enter the
  378.           command 'w' for Write and YAM/ZCOMM responds: 'Write to file:' 
  379.           To this prompt just enter a file name or 'prn' to send it to the
  380.           printer.  This allows you to cut information that scrolled off
  381.           the screen and save it for later.  You can even 'read' a file
  382.  
  383.  
  384.  
  385.                                                                     Page: 6
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.           PHOMAST.DOC                                           Michael Ash
  399.  
  400.  
  401.  
  402.           into the circular buffer.  At the command line give the command
  403.           'read filespec' and the file will be put into the buffer.
  404.  
  405.  
  406.                           --- Some useful shortcut keys ---
  407.  
  408.               Alt-1  is DOS shell where you can enter a DOS command
  409.               Alt-2  is YAM/ZCOMM command line where you can enter command
  410.               Alt-D  is current directory contents
  411.               Alt-W  writes open capture file
  412.               Alt-C  closes an open capture file.
  413.               Alt-M  changes keyboard mapping if you have others defined
  414.               Alt-N  NUKE key - aborts whatever process running
  415.               Alt-S  Shows status of running comm package
  416.  
  417.               Alt-Q  once download complete will log you off host.  The
  418.                      string sent by Alt-Q is define by 'set quitcmd' in
  419.                      the script.  To activate, hit Alt-Q once a download
  420.                      is started...
  421.  
  422.               Alt-Z ZAPS a copy of the screen saving it into a file called
  423.                     YAMPIC.  To see the file use the DOS file UNPIC.EXE and
  424.                     give the command UNPIC YAMPIC.  To save the screen as a
  425.                     file use 'UNPIC YAMPIC > filespec' at the DOS prompt or
  426.                     use '!UNPIC YAMPIC' at the YAM/ZCOMM prompt.
  427.  
  428.               Ctrl-Home - Blanks the screen when on-line
  429.  
  430.               F4    -- ASCII Upload (for sending messages prepared offline)
  431.               F9    -- Help Menu
  432.               F10   -- On-Line Manual
  433.               Shift-F6  -- Modify default Configuration / Colors
  434.  
  435.  
  436.           When writing script files the '!' is used for DOS shell and '@'
  437.           used to execute a YAM/ZCOMM command... (e.g. !chkdsk will run
  438.           Check Disk).  That should get you going!  Once you are up and
  439.           running look at the other commented features that will give you
  440.           even more POWER... 
  441.  
  442.                              --- So what are the Menus ---
  443.                
  444.           Once YAM/ZCOMM is loaded, if you hit 'F9' you will see the
  445.           following menu options.  
  446.                
  447.                F3   OPEN Capture file 
  448.  
  449.  
  450.  
  451.                                                                     Page: 7
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.           PHOMAST.DOC                                           Michael Ash
  465.  
  466.  
  467.  
  468.                F4   Send ASCII Text  (sending messages prepared offline) 
  469.                F5   Send Kermit Upload 
  470.                F6   Send Zmodem Upload <<BEST>> 
  471.                F7   Receive CrcXmodem Download 
  472.                F8   Send CrcXmodem Upload 
  473.                F9   Press for THIS HELP SCREEN 
  474.                F10  On-Line Manual
  475.                
  476.                Alt-1 Get DOS Command prompt 
  477.                Alt-2 Get ZCOMM Command prompt 
  478.                
  479.                Shift-F3  HOLDING Pattern online to keep the other end from
  480.                          timing out and disconnecting.  Basically, the
  481.                          HOLDING Pattern sends a space/backspace to the 
  482.                          host every 2 seconds...
  483.  
  484.                Shift-F4  Use Script Writer to generate your own autologon
  485.                Shift-F6  Change your Modem / Color Configuration 
  486.                Shift-F7  Demonstration of dialing menu DIAL.T
  487.                
  488.                Alt-F1    AutoLog B&F Tech BBS at 2400 baud
  489.                Alt-F2    AutoLog Olde Guard 2400 baud
  490.                Alt-F3    Write and then close opened Capture file 
  491.                Alt-F4    Call CompuServe demo account at 1200 baud
  492.                Alt-F5    Call PC Magazine BBS
  493.                Alt-F6    Force local system into HOST MODE operation
  494.                Alt-F7    Sign your name with a function key 
  495.                ALT-F9    Edit PHOMAST.T SCRIPT  (Note:  You can change
  496.                          this Function Key assignment to use your
  497.                          preferred editor.)
  498.                
  499.               TO CALL OTHER BBSs:  enter 'call name' where name is a label 
  500.  
  501.               To DIAL A NUMBER enter number followed by ';t' For example
  502.               use the format '523-8994;t'
  503.  
  504.               -- CompuServe-B, KERMIT, and ZMODEM download automatic --
  505.                
  506.              Stop Redialing ---- press <CR> Hangup w/o pgm exit - enter 'o'
  507.              To exit program just get to the command line and enter 'off'
  508.                
  509.              Alt-N EMERGENCY EXIT, 'Nuke It' to get command line
  510.                
  511.  
  512.                        ----------------------------------------
  513.  
  514.  
  515.  
  516.  
  517.                                                                     Page: 8
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.           PHOMAST.DOC                                           Michael Ash
  531.  
  532.  
  533.  
  534.                    --- Specialized Keyboard Mapping information ---
  535.  
  536.           YAM/ZCOMM lets you completely remap the keyboard if you wish. 
  537.           Below is an example of a special application for Digital
  538.           Equipment interface that you could add to a script.  I have
  539.           included the following advanced discussion here to supplement
  540.           normal documentation in case you need to utilize this powerful
  541.           keyboard mapping command.  The bottom line is any that key can be
  542.           mapped to send any character string to the host computer.
  543.  
  544.           Note:  From the YAM/ZCOMM command line you can find the number
  545.           of the key sequence by entering a underline char "_" (underscore
  546.           command) followed by a return...  This will display the key
  547.           sequence strings in a series of 4 numbers.  For example hitting
  548.           the letter 'a' will produce: 30 30 0 0141 (Hitting Ctrl-a
  549.           produces 30 30 4 0001).  The first two numbers are the
  550.           'scancodes' and actually the second number is the best to use
  551.           since it will take into account extended keyboard functions.  The
  552.           third number shows the ShiftState which is actually the numeric
  553.           sum of what other keys are hit with the selected key.  The
  554.           numbers are defined as follows:
  555.  
  556.               0  -  no other key hit with the target key
  557.               1  -  the Right Shift key was held down as the key was hit
  558.               2  -  the Left Shift key was held down as the key hit
  559.               4  -  the Ctrl key held down as key hit
  560.               8  -  the Alt key held down as key hit
  561.  
  562.               16 -  provided the Shift, Ctrl, and Alt key states match,
  563.                     select this mapping regardless of whether the
  564.                     Application Keypad Mode or the Decoded Function Key
  565.                     conditions (below) are true.
  566.  
  567.               32 -  Alternate Keypad Mode (not numeric)
  568.  
  569.               64 -  Decoded Function Key (Character value > 0400 as
  570.                     displayed by _ (underscore) command.
  571.  
  572.               128 - Select this mapping unconditionally 
  573.  
  574.           You can even have specific combinations by summing the keys held
  575.           down.  For example if the ShiftState is 3 this means both Right
  576.           and Left Shift keys held down.  If the number is 14 means the
  577.           Right shift (2), the Ctrl (4) and the Alt (8) key were all held
  578.           down when the key hit (2+4+8=14).  As you can see this gives you
  579.           very specific mapping even taking into account simultaneous use
  580.  
  581.  
  582.  
  583.                                                                     Page: 9
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.           PHOMAST.DOC                                           Michael Ash
  597.  
  598.  
  599.  
  600.           of multiple keys.
  601.  
  602.           For more information see pg 184 under Terminal Emulation in the
  603.           YAM manual you receive when you register YAM or ZCOMM.  Actual
  604.           keyboard mapping utilizes the command 'mk' with the following
  605.           syntax :
  606.  
  607.                        mk  Scancode  ShiftState  Class  String
  608.           where:
  609.  
  610.               Scancode - Explained above using the '_' function.  Take the
  611.           SECOND number displayed as the scancode to use here.
  612.  
  613.               ShiftState - numeric sum of what other keys are hit as
  614.           explained above.  Special case 128 maps unconditionally as with
  615.           Ctrl Arrow keys... 
  616.  
  617.               Class - determines the type of string to put ahead of your
  618.           selected sting.  This saves you having to enter the 'ESC[' at the
  619.           start of each string for example.
  620.  
  621.               Class 0 in VT mode puts "ESC[" before string
  622.               Class 1 in VT52 mode, ESC is prepended, otherwise "ESC O"
  623.               Class 2 specialized for Keypad, Not mapped in numeric mode
  624.               Class 3 puts just "ESC" before string
  625.               Class 4 nothing is added
  626.  
  627.           Here is a brief example of what you can do...
  628.  
  629.                     mk                    :Clear old mapping
  630.                     display mapkb vt100   :Setup VT100 display
  631.                     pN2                   :Turn off NumLock
  632.                     mk 72 16 0 A          : Up arrow (class=0 sends:ESC[A )
  633.  
  634.                     mk 80 16 0 B          : Down arrow
  635.                     mk 75 16 0 D          : Left arrow
  636.                     mk 77 16 0 C          : Right arrow
  637.                     mk 41 1 0 \d52\d126   : Map rf-Shift-~ sends: ESC[4~
  638.                     mk 41 2 0 \d52\d126   : Map lf-Shift-~ sends: ESC[4~
  639.                     
  640.                     mk 28 4 0 31~         : Ctrl-Enter Insert line Esc[31~
  641.                     mk 21 4 0 32~         : Ctrl-Y delete line Esc[32~
  642.                     mk 115 128 3 OR       : Ctrl-Left move one word left
  643.                     mk 116 128 3 OQ       : Ctrl-Right move one word right
  644.                     
  645.           Example of fKEY mapping...
  646.  
  647.  
  648.  
  649.                                                                    Page: 10
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.           PHOMAST.DOC                                           Michael Ash
  663.  
  664.  
  665.  
  666.                     set f10 "\E[21~"      : Map F10 to Abort  (ESC[21)
  667.                     set fpgup "\E[6~"     : Map PgUp to previous screen
  668.                     set fpgdn "\E[5~"     : Map PgDn to next screen
  669.                     set fins "\E[2~"      : Map INS key to Esc[2~
  670.                     set bs "@mput \177"   : Map BackSpace key to be Del     
  671.                
  672.  
  673.               The above examples demonstrate that you can do essentially
  674.               anything you want to do...
  675.  
  676.  
  677.           -----------------------------------------------------------------
  678.  
  679.                   <<< Comments below courtesy of Bob Willoughby >>>
  680.  
  681.           This is a "hands-on" script.  It incorporates three "auto logon"
  682.           examples which show how to write an auto logon script.  They
  683.           include auto logons to B&F, Olde Guard BBS here in San Antonio,
  684.           Texas and a demo account area of CompuServe... 
  685.  
  686.           You can generate an autolog script like the ones above using the
  687.           TurboLearn Script(tm) (Shift-F4).  This will actually create
  688.           rough script that you can later refine and add to PHOMAST.T and
  689.           run from there.  Having WildCat, TComm, and CompuServe examples
  690.           to work from lets you see lots of tricks that will help you
  691.           generate other automatic scripts.  They can be made so
  692.           sophisticated that you can completely automate any procedure...
  693.  
  694.           Examples of auto logon scripts may be found in PHOMAST.T and in
  695.           Chuck Forsberg's phone scripts distributed with YAM/ZCOMM.  Other
  696.           examples are included in the file SCRIPTS.ZOO which may be
  697.           downloaded from Telegodzilla, the YAM/ZCOMM support BBS.  The
  698.           YAM/ZCOMM manual explains how such auto logon scripts are
  699.           constructed and how to use the TurboLearn(tm) feature to automate
  700.           writing scripts.  I recommend new users use this script
  701.           essentially "as is" for a while to test your new phone directory
  702.           entries and become familiar (comfortable) with YAM/ZCOMM.  Then
  703.           you can enjoy the challenge, the fun, and the satisfaction of
  704.           modifying this script to add auto logon procedures, dial queues,
  705.           and the like.
  706.  
  707.           Keep in mind that this is only an example script to use in
  708.           learning basic ZCOMM functions.  You will have plenty of time to
  709.           enhance and embellish this script later. 
  710.  
  711.             -------------------------------------------------------------
  712.  
  713.  
  714.  
  715.                                                                    Page: 11
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.           PHOMAST.DOC                                           Michael Ash
  729.  
  730.  
  731.  
  732.  
  733.           The only files you must have are YAM.EXE (or ZCOMM.EXE) and this
  734.           phones file PHOMAST.T -=- The following files are included in the
  735.           PHOMAST6.ZIP file:
  736.  
  737.                PHOMAST.T    -- the actual code YAM/ZCOMM reads
  738.                PHOMAST.DOC  -- this documentation file
  739.                   DIAL.T    -- simple example of a dialing menu (optional)
  740.               HOSTHELP.TXT  -- external help text for HOST mode (optional)
  741.               TUF_FONS.T    -- an alternative, no-frills phones script
  742.                  WHATS.NEW  -- changes since PHOMAST5.T of one year ago     
  743.                   COMM.BAT  -- example of BATCH file to call YAM/ZCOMM
  744.  
  745.  
  746.  
  747.                        ----------------------------------------
  748.  
  749.  
  750.  
  751.           I have tried to make this script as perfect as possible but like
  752.           most things in life there are no guarantees that I found
  753.           everything.  I wish you the best of luck with YAM or ZCOMM. 
  754.           Please let me know if you run into problems...
  755.                               
  756.           I have spent hundreds of hours over many years on this script to
  757.           make ZCOMM or YAM useful to new users right out of the starting
  758.           block.  If this has helped you get a better grasp of the package
  759.           I would like to hear from you.  If this really made a difference,
  760.           and you think my time is was well spent, throw a couple bucks my
  761.           way and I will go out for a Taco (what else in San Antonio...).
  762.  
  763.           Regardless, I would appreciate a postcard, just to get an idea
  764.           who this script finally reached...
  765.  
  766.  
  767.                                                       Michael Ash
  768.                                                       3766 Tupelo Ln #2904
  769.                                                       San Antonio, TX 78229
  770.  
  771.  
  772.  
  773.  
  774.                             ---------- Have Fun ----------
  775.  
  776.  
  777.  
  778.                                                                    Page: 12
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.